package paidaxing.blog.comment.mapper;

import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import paidaxing.blog.comment.entity.Comments;
import java.util.List;

@Mapper
public interface CommentMapper {
    /**
     * 根据ID查询评论
     *
     * @param id 评论ID
     * @return 评论实体
     */
    Comments queryById(Long id);

    /**
     * 插入评论
     *
     * @param comments 评论实体
     * @return 影响行数
     */
    int insert(Comments comments);

    /**
     * 更新评论
     *
     * @param comments 评论实体
     * @return 影响行数
     */
    int update(Comments comments);

    /**
     * 根据ID删除评论（逻辑删除）
     *
     * @param id 评论ID
     * @return 影响行数
     */
    int deleteById(Long id);

    /**
     * 根据文章ID查询评论列表
     *
     * @param postId 文章ID
     * @return 评论列表
     */
    List<Comments> selectCommentsByPostId(@Param("postId") Long postId);

    /**
     * 根据文章ID和分页参数查询评论列表
     *
     * @param postId 文章ID
     * @param offset 偏移量
     * @param limit 每页数量
     * @return 评论列表
     */
    List<Comments> selectCommentsByPostIdAndPage(@Param("postId") Long postId, @Param("offset") int offset, @Param("limit") int limit);

    /**
     * 根据父评论ID查询子评论列表
     *
     * @param parentId 父评论ID
     * @return 子评论列表
     */
    List<Comments> selectCommentsByParentId(@Param("parentId") Long parentId);
}